home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / grabsc11 / grabscrn.doc < prev    next >
Text File  |  1990-11-29  |  5KB  |  106 lines
  1.             GrabScrn - Screen Grabber Ver 1.1
  2.             ---------------------------------
  3.  
  4.   BECAUSE GRABSCRN IS LICENSED FREE OF CHARGE, I PROVIDE ABSOLUTELY NO
  5. WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT WHEN
  6. OTHERWISE STATED IN WRITING, I GERSHON ELBER PROVIDE GRABSCRN PROGRAM
  7. "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
  8. BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  9. A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  10. PROGRAM IS WITH YOU. SHOULD THE GRABSCRN PROGRAM PROVE DEFECTIVE, YOU ASSUME
  11. THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  12.  
  13.   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL GERSHON ELBER,
  14. BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES,
  15. OR OTHER SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  16. USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR A
  17. FAILURE OF THE PROGRAM TO OPERATE WITH PROGRAMS NOT DISTRIBUTED BY GERSHON
  18. ELBER) THE PROGRAM, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
  19. SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  20.  
  21.  
  22. Introduction
  23. -------------
  24. This program dumps the graphics screen as a linear non compressed data. An
  25. auxiliary program is provided to convert this raw data into an GIF image.
  26. GrabScrn is a TSR program. First time it is executed it leaves a resident
  27. portion that is activated by the hot key ALT-F10. Each time the hot key is
  28. pressed three new files named 'GrScrxxx.yyy' are created where xxx is an index
  29. increased by one each time up to 999 and yyy is one of "bat", "cmp" and "raw".
  30.  
  31.  
  32. Usage
  33. -----
  34. Usage: GrabScrn [-d] Device
  35. where
  36.     Device may be one of:
  37.     1. HERC - 720 by 350 1 bit per pixel (2 colors).
  38.     2. CGAL - 320 by 200 2 bits per pixel (4 colors).
  39.     3. CGAH - 640 by 200 1 bits per pixel (2 colors).
  40.     4. EGALO - 640 by 200, default 4 bits per pixel (16 colors).
  41.     5. EGAMED - 640 by 350, default 4 bits per pixel (16 colors).
  42.     6. VGALO - 640 by 200, default 4 bits per pixel (16 colors).
  43.     7. VGAMED - 640 by 350, default 4 bits per pixel (16 colors).
  44.     8. VGAHI - 640 by 480, default 4 bits per pixel (16 colors).
  45.     9. SVGA - 800 by 600, default 4 bits per pixel (16 colors).
  46.     10. UVGA - 1024 by 768, default 4 bits per pixel (16 colors).
  47.     d is optional bits per pixel digit. Default is specified above.
  48.  
  49. Once GrabScrn is installed, device may be modified by simply reexecuting
  50. GrabScrn with a new device name. Note device name must be in UPPER CASE.
  51.  
  52. The three files saved each time the hot key is been pressed are:
  53. GrScxxx.raw - the screen information in raw data format - one screen raw
  54.     after another with one byte per pixel. xxx is image number up to 999.
  55. GrScrxxx.cmp - The color map. This is a regular text file with one entry per
  56.     line of the form "Index Red Green Blue".
  57. GrScrxxx.bat - Batch file, that when executed converts the raw and color
  58.     map files above into a gif image. The raw and cmp files are been
  59.     deleted once done.
  60.     A tool named Raw2Gif from the giflib11.zip gif tool kit
  61.     (see PD:<MSDOS.GIF> on simtel20.arpa) is used for that purpose and
  62.     is provided here for completeness purposes. See Raw2Gif.doc for more.
  63.  
  64. Two examples of color map files are provided. one for ega default color
  65. palette (colormap.ega) and one for hercules (colormap.her).
  66.  
  67.  
  68. General notes
  69. -------------
  70. The raw files are always saved as one byte per pixel. This was made mainly
  71. from simplicity reasons although it may require lots of disk space. All CGA
  72. EGA and VGA modes uses the bios int 0x10, service 0x0c to retrieve the
  73. screen buffer information and service 0x1015 to retrieve the palette.
  74. This ensures compatibility on the expense of time. The following
  75. table hints on the space/time requirement for single screen dump:
  76.  
  77. Device | File size  | time (80286 12Mhz) | Comments
  78. -------+------------+--------------------+----------------
  79. HERC   |   252000   |  9 Sec.         |
  80. EGA    |   224000   |  49 Sec.         | 640 x 350 mode (EGAMED)
  81. VGA    |   307200   |  67 Sec.         | 640 x 480 mode (VGAHI)
  82. SVGA   |   480000   |  97 Sec.         | 800 x 600 mode (SVGA)
  83.  
  84. The Hercules mode queries bits information directly (no BIOS support for it)
  85. and the speedup is obvious...
  86.  
  87. Because of the complexity envolved in detecting different modes and devices
  88. a safer approach has been taken and it is the user responsibility to
  89. "tell" this program what mode the device will be in once the hot key is
  90. been pressed.
  91.  
  92. Although this program was designed to minimize machine dependability,
  93. it uses fairly low level calls and it may not work on your system.
  94. If it does not, but you fixed it to work for your system, please send me
  95. your changes so I can incorporate them in. If you can not - please do not
  96. send me any specific machine problem kind of mail unless you are willing to
  97. buy me a system like yours - I am not going to buy one...
  98.  
  99. The GrabScrn.c module can be easily modified to support other display
  100. devices. If you did that, please send me your changes so I can incorporate
  101. them into this program officially.
  102.  
  103. Gershon Elber
  104. Email: gershon@cs.utah.edu
  105.  
  106.